一般情况下,物联云平台SDK(以下简称SDK)的使用过程大致如下图所示:
1.配置/初始化/启动SDK
+
|
v
2.用户授权
+
|
+---------+---------+
| |
v v
5.同步设备列表 3.扫描设备
+ +
| |
| v
+-------------+4.绑定并订阅设备
|
+------------v---------+---------------------+
| | |
v v v
6.设置/查询物模型属性 7.接收设备状态回调 8.接收云端推送
接收设备物模型属性上报
1.配置/初始化/启动SDK
在使用SDK之前,必须先配置/初始化SDK,因为SDK的正常运行依赖于这些配置,因此务必设置正确,正常情况下使用默认配置就可以。
另外在调用SDK的其他方法,或者要接收SDK的回调是,必须先启动SDK,即调用**[[XLinkSDK share] start]或者[[XLinkSDK share] startWithConfig:config]**。
2.用户授权
用户授权即常见的用户登录,如果需要使用SDK的云端功能,例如需要通过云端控制设备,或者订阅设备,必须保证用户授权成功。
3.扫描设备
这个指的是APP在局域网中发现设备。成功扫描到设备的必要前提是APP和设备连接同一个局域网,并且在同一网段,简单理解就是连接着同一个路由器。同时需要保证扫描设备的时候传入的产品ID和设备的产品ID一致。
4.绑定并订阅设备
绑定设备是指APP和设备在局域网中通过相关的协议获取到局域网的配对信息,之后APP和设备的局域网连接的凭证就是这个配对信息。
订阅设备指的是在云端建立用户和设备的绑定关系。用户在订阅设备之后,才可以通过云端连接设备、控制设备以及监听设备的上报数据,另外可以通过获取设备列表的接口获取到用户已订阅的设备。
绑定并订阅设备成功之后,SDK内部会维护APP和设备之间的连接。
5.同步设备列表
同步设备列表会获取用户已经订阅的设备列表并且返回,另外同步设备列表之后,SDK内部会维护APP和设备之间的连接。
6.设置/查询数据端点、接收设备数据端点上报
在APP和设备建立连接之后,APP可以对设备进行设置或者查询数据端点。一般来说,设置数据端点就是APP对设备进行控制的指令操作。查询数据端点就是获取设备上的最新的状态。
另外当设备的数据发生变化时,会向APP和云端发送数据端点列表,这个会通过设备数据端点上报的回调。
7.接收设备状态回调
APP调用了同步设备列表、连接设备或者绑定订阅设备操作后,SDK都会维护和设备之间的连接,并且通过设备状态的回调方法给到APP。APP可以根据最新回调的设备连接状态进行界面的更新。
8.接收云端推送
云端推送可以理解为应用内推送,在APP和云端连接之后,可以接收到云端发送过来的实时消息,包括有设备的告警消息、分享消息等。可以根据具体业务的情况处理对应的云端推送。